<!DOCTYPE html>
<html lang="en">

<head>
    <meta charset="utf-8">
    <title>触发事件</title>
    <link rel="stylesheet" href="css/amazeui.min.css" />
    <link rel="stylesheet" href="css/app.css">
    <link rel="stylesheet" href="css/bootstrap.css">
    <link rel="stylesheet" href="css/bootstrap-theme.css">
    <script src="js/jquery.min.js"></script>
    <script src="js/amazeui.min.js"></script>
    <script src="js/app.js"></script>
    <script src="js/bootstrap.js"></script>

    <style>
        h2{
            font-size: 24px
        }
        img{
            margin-top: 5px;
            border: 1px #ddd solid;
        }
    </style>
</head>

<body data-type="widgets">
<script src="js/theme.js"></script>
<div class="am-g tpl-g">
    <!-- 内容区域 -->
    <div class="row-content am-cf">
        <div class="row">
            <div class="am-u-sm-12 am-u-md-12 am-u-lg-12">
                <div class="widget am-cf">
                    <div class="widget-head am-cf">
                        <div class="widget-title  am-cf">API文档 - 触发事件</div>
                    </div>
                    <div class="widget-body  am-fr">
                        <h1 style="font-size: 36px;margin-bottom: 40px">触发事件</h1>
                        <div class="am-u-sm-12">
                            <h2>1、功能描述</h2>
                            <span class="describeMainPage">
                                用户可通过您设定的词条触发类型来达到用户回复词条所需要的目的。<br/>
                                您可以在添加词条中设置该词条触发类型为所提供的的触发类型。
                            </span>
                        </div>
                        <div class="am-u-sm-12">
                            <h2>2、词条设置</h2>
                            <span class="describeMainPage">
                                添加词条，类型选为网站，添加需要打开的网站地址信息。<br/>
                                <img src="img/webopen.jpg" alt=""><br/><br/>
                                添加音乐类型的词条数据，音乐地址为：https://m801.music.126.net/20191023094936/688f1e1d03d7f8128cd938f9a5ca4460/jdyyaac/015a/5252/545c/60504ecac4e8e44ac0c3c6904494a63e.m4a<br/><br/>
                                <img src="img/openmusic.jpg" alt=""><br/>
                            </span>
                        </div>
                        <div class="am-u-sm-12">
                            <h2>3、输入参数</h2>
                            <span class="describeMainPage">
                                以下接口列出了调用接口必要的接口参数<br/>
                                <table class="table table-bordered">
                                    <tr class="active">
                                        <td>参数名</td>
                                        <td>必选</td>
                                        <td>类型</td>
                                        <td>描述</td>
                                    </tr>
                                    <tr>
                                        <td>appId</td>
                                        <td>是</td>
                                        <td>String</td>
                                        <td>您的词库账号下AppId，用于标识账户Id、词库Id。</td>
                                    </tr>
                                    <tr>
                                        <td>keyWord</td>
                                        <td>是</td>
                                        <td>String</td>
                                        <td>用户问的问题，调用关键词。</td>
                                    </tr>
                                </table>
                            </span>
                        </div>
                        <div class="am-u-sm-12">
                            <h2>4、输出文档</h2>
                            <span class="describeMainPage">
                                以下接口仅列出了父级参数，如需看全，详情请看 <a href="#">《返回参数》</a><br/>
                                <table class="table table-bordered">
                                    <tr class="active">
                                        <td>参数名</td>
                                        <td>类型</td>
                                        <td>描述</td>
                                    </tr>
                                    <tr>
                                        <td>requestCode</td>
                                        <td>String</td>
                                        <td>返回的调用词条状态码</td>
                                    </tr>
                                    <tr>
                                        <td>describe</td>
                                        <td>String</td>
                                        <td>返回数据的描述</td>
                                    </tr>
                                    <tr>
                                        <td>requestMap</td>
                                        <td>Map</td>
                                        <td>返回的结果数据，如需查看详情，请看<a href="returnParameter.html">《返回参数》</a>。</td>
                                    </tr>
                                </table>
                            </span>

                        <div class="am-u-sm-12">
                            <h2>5、尝试接入</h2>
                            <p>通过该请求即可请求到您的词库数据，下面用HTML，Ajax请求来作为示例（该请求可使用多种请求方式，请求方式语言不唯一），演示操作。</p>
                            <div class="codeStyle">
                                http://www.aixtport.com/aichild/api-intervention/transfer?appId=KjwYvtg4wHaXZY2hoJKAmQtCv0ZtSS&keyWord=test
                            </div>
                            <div class="code">
                                <xmp>
        <script>
            $(function (){
                $.ajax({
                    type:"POST",//规定传输方式
                    url:"http://www.aixtport.com/aichild/api-intervention/transfer", //小童请求接口
                    data:{"keyWord":"小童","appId":"KjwYvtg4wHaXZY2hoJKAmQtCv0ZtSS"}, //传入参数
                    //注：代码中的appId是小童私人助手appId，无效的，有效的，Ai小童官方公用appId：zl2plygQdHGngSqNtTPI6CqyV73NA5
                    success: function(data){
                        if(data.requestMap.result.replyContents == null){
                            $("#result").html("")
                        }else{
                            if(data.requestMap.result.rriggerType == "2"){
                                //加载音乐，使用iframe内联框架来触发您的音乐地址，从而可以达到本页面响应音乐效果。
                                $("#iframeSrc").attr("src",data.requestMap.result.rriggerPath);
                            }else if(data.requestMap.result.rriggerType == "3"){
                                //window.location.href="http://www.baidu.com";  //本窗口打开
                                window.open(data.requestMap.result.rriggerPath) //新窗口打开，有些浏览器会阻拦
                            }
                            $("#result").html(data.requestMap.result.replyContents)
                        }
                        //任意代码操作
                    }
                });
            })
        </script>

        <!--触发音乐可用的iframe内联框架-->
        <iframe id="iframeSrc" style="display: none"></iframe>
                                </xmp>
                            </div>
                        </div>
                            <div class="am-u-sm-12">
                                <h2>6、测试效果</h2>
                                <span class="describeMainPage">
                                网站类型词条效果测试git图<br/>
                                <img src="img/webtest.gif" alt=""><br/><br/>
                                    音乐数据测试效果图<br/><br/>
                                    <img src="img/testmusic.jpg" alt="">
                            </span>
                        <div class="am-u-sm-12">
                            <h2>7、获取参数信息</h2>
                            <p>可是用输出控制台消息，来作为示例，获取返回的结果信息。</p>
                            <div class="codeStyle">
                                console.log(data.describe)  //返回信息描述<br/>
                                console.log(data.requestCode)   //返回请求状态码<br/>
                                console.log(data.requestMap.result.replyContents)  //回调内容<br/>
                                console.log(data.requestMap.result.rriggerPath)    //回调路径<br/>
                                console.log(data.requestMap.result.rriggerType)    //触发Id<br/>
                                console.log(data.requestMap.result.triggerName)    //回调内容
                            </div>
                        </div>

                        <div class="am-u-sm-12">
                            <h2>8、开发者测试环境</h2>
                            <span class="describeMainPage">
                                您可以通过浏览网页形式来测试您的接口和词库数据，<a href="http://www.aixtport.com/xt/test.html" target="_blank">Ai小童接口环境测试</a>。
                            </span>
                        </div>

                        <div class="am-u-sm-12">
                            <h2>对您有帮助吗？</h2>
                            <p>不管有无帮助，一起加入Ai小童大家庭吧！在这里您有很大的展现平台，您可以学到很多东西，赶快加入我们吧！<a target="_blank" href="//shang.qq.com/wpa/qunwpa?idkey=4972957ba2c09266ef2e637a5a559657fbdb0588ef927b2b62f200b77e64f17e" style="margin-top: -2px"><img border="0" src="//pub.idqqimg.com/wpa/images/group.png" alt="Ai小童云智能引擎官方" title="Ai小童云智能引擎官方"></a></p>
                        </div>
                    </div>
                </div>
            </div>
        </div>
    </div>
</div>
</body>
</html>